home *** CD-ROM | disk | FTP | other *** search
/ Aminet 1 (Walnut Creek) / Aminet - June 1993 [Walnut Creek].iso / aminet / mus / edit / amisox_wav.readme < prev    next >
Text File  |  1992-08-13  |  8KB  |  179 lines
  1. Short: SOX and Sound Tools Update for .WAV support
  2.  
  3. -----
  4. BRIEF
  5. -----
  6. Here is my Amiga port of the SoundTools kit, including SOX, the Sound
  7. Exchange.  The original Unix archive is available via anonymous ftp
  8. from wuarchive.wustl.edu:/usenet/alt.sources/articles/517[6-9].Z.  I
  9. have placed all my modifications of the Unix code within #ifdef
  10. delimiters, so the Amiga code should still compile under BSD or SysV
  11. using the original Makefile (Makefile.unix).  Use the Makefile.amiga
  12. to compile for AmigaDOS, or use the supplied shell script if you
  13. don't own a compliant "make" program.
  14.  
  15.  
  16. ---------
  17. NEW STUFF
  18. ---------
  19. Support for Windows 3.1 .WAV support is now included.  Thanks to Bill
  20. Neisius for the WAV driver.  I didn;t have the full patch at the time
  21. I updated the Amiga version to support .WAV, so changes to handlers.c
  22. and everything else are mine (and noted as such--just grep for my
  23. initials).  Changes to incorporate this driver were not machine-
  24. dependent; thus you can compile this Amiga patch on your Sparc or
  25. whatever else and (presto!, big flourish) have .wav support there,
  26. too.
  27.  
  28.  
  29. -----------
  30. AMIGA NOTES
  31. -----------
  32. Read the file "sox.man.ascii" for general information.  This is a pure
  33. text copy of the troff file "sox.man", though, and as such, it
  34. describes the Unix version.  The following are peculiarities to the
  35. Amiga version:
  36.  
  37. - the ".iff" filename extension and type specifier operates
  38.   identically to the ".8svx" extension
  39. - piping as described in the manual does not work.  I might try to
  40.   fix this, but given the piping means available on the Amiga, it
  41.   could be rough.  The pipe: device should work on everything but
  42.   VOC files as long as you use proper filename extensions or type
  43.   specifications, but I can't see why you'd want to use it anyway.
  44. - The Amiga version of sox incorporates a version string, so typing
  45.   "version sox" should tell you what version of the binary you have.
  46. - If you want to keep libst.lib, you'll have access to most of sox's
  47.   functions through a compiler library as documented in the files
  48.   "st.man" (troff) and "st.man.ascii" (ascii).  Put this in your
  49.   lib: directory if you're interested in it.
  50. - skel stuff, as coded in skel.c and skeleff.c and documented in
  51.   st.man[.ascii], is not yet supported.  Trying to compile it
  52.   under SAS sent out loads of errors, but I didn't think them
  53.   immediately worth fixing since skel*.c is only good for expansion
  54.   using libst.lib.  I may fix these up for a future release.
  55. - The supplied varargs.h is from my local BSD unix machine, and is
  56.   used without permission.
  57.  
  58. And, regarding the Sound Tools library and its documentation
  59. ("st.man" for troff, "st.man.ascii" for ascii):
  60.  
  61. - On the current Unix version of Sound Tools, the library is named
  62.   "libst.a".  Some old documentation refers to it as "libsk.a".
  63.   For the Amiga, replace any occurrence of either of these words
  64.   with "libst.lib", the name of the Amiga library.
  65.  
  66.  
  67. -----
  68. FILES
  69. -----
  70. *.c                     C source code for Sound Tools kit and SOX
  71. *.h                     C header files for ST and SOX
  72. libst.lib               Sound Tools compiler library, non-FPU version
  73. libst881.lib            Sound Tools compiler library, FPU version
  74. Makefile.amiga          Makefile for Amiga version of ST
  75. Makefile.unix           Original Unix Makefile
  76. README                  Original Sound Tools README file
  77. README.amiga            Notes on Amiga port
  78. sox                     Amiga Sound Exchange, non-FPU version
  79. sox.man                 Original Unix SOX manual, (troff format)
  80. sox.man.ascii           Original Unix SOX manual, (ASCII format)
  81. sox881                  Amiga Sound Exchange, FPU version
  82. st.man                  Original Unix Sound Tools Library manual (troff)
  83. st.man.ascii            Original Unix Sound Tools Library manual (ASCII)
  84. TODO                    Things to be done for original Unix distribution
  85.  
  86. I've supplied a number of scripts for making specific conversions
  87. with sox.  These are contained in the archive "scripts.lha", and
  88. further documentation on them is available therein.
  89.  
  90.  
  91. ----------
  92. LAST NOTES
  93. ----------
  94. Windows 3.1 .WAV support is now included; see above.
  95.  
  96. Some channel conversions on IFF-8SVX files require the creation of
  97. a temporary file which by default is written to the t: logical
  98. device.  If you perform any of these conversions, be sure you have
  99. enough free store in t: for such a file.
  100.  
  101. The FPU version of the Sound Tools library, libst881.lib, must be
  102. linked with a 68881/2 library to resolve math coprocessor calls.
  103. For Lattice/SAS C, use lib:lcm881.lib.
  104.  
  105. Some of the .c files compile with type warnings, but the binaries
  106. seem to work fine.  If you have any trouble, please let me know.
  107.  
  108. Not all of the type identifiers are immediately obvious; for example,
  109. the type spec for a ulaw sound is "-t .au", rather than "-t ulaw".
  110. You can find all of the type specs buried inside the file
  111. "handlers.c".
  112.  
  113. The outstanding (only, let's hope) bug in the Amiga version of the
  114. package is that the ami.o module (thus SOX and the libst.lib
  115. routines) does not know how to delete its temp files.  If anyone
  116. can show me a good way to do this (perhaps by walking struct
  117. pointers?), I'd be a happy programmer.
  118.  
  119. When I'm satisfied with the state of the Amiga port, I'll mail it to
  120. the original author, Lance Norskog, in hope that future releases of
  121. and patches to the kit will be Amiga-compatible.
  122.  
  123. (Incidentally, the whole porting project was really relatively easy.
  124. I'm surprised no one else has done it yet.)
  125.  
  126. As with the original Sound Tools package, the Amiga SOX and Sound
  127. Tools Library are freely distributable, but the original code is
  128. copyrighted by Lance Norskog.  Amiga modifications are copyright
  129. David Champion; they may be distributed or modified in any way so
  130. long as a notice to this effect and a concise description of any
  131. changes are included with the distribution.  See the file "README"
  132. for the details on SOX code rights and restrictions.  See "wav.c"
  133. for ownership of the WAV driver.
  134.  
  135. Finally, I suggest that, whenever possible, you use Mike Cramer's
  136. SoundZAP for XXX->IFF conversions; it's generally much faster.  I
  137. do.  The only time I can really justify using SOX is for effects
  138. other than rate changes and for conversions to types other than IFF.
  139.  
  140. ----------------------
  141. CREDITS & AUTHOR STUFF
  142. ----------------------
  143. Thanks to the following folks for help on a few problems I had with
  144. the Amiga's lack of certain functions, and for suggestions on
  145. features to support:
  146.  
  147. caw@miroc.Chi.IL.US (Christopher A. Wichura)
  148. psd1@midway.uchicago.edu (Pratik S. Dave)
  149. epang@sfu.ca (Eugene Pang)
  150. asd2@optima.rh.uchicago.edu
  151. "--SeebS--" <har@ux.acs.umn.edu>
  152. Raul Deluth Miller-Rockwell <rockwell@socrates.umd.edu>
  153. S.Raybould@fulcrum.bt.co.uk
  154. "Edward D. Berger" <eb15+@andrew.cmu.edu>
  155. Jonathan Potter <jpotter@itd.adelaide.edu.au>
  156. Gordon Keener <flash@unx.sas.com>
  157. webbs@mozart.cs.colostate.edu (Steven Webb (The walking glitch))
  158. fnx!del@pilchuck.data-io.com (Dag Erik Lindberg)
  159. robtu@itx.isc.com
  160. wusel@hactar.hanse.de (Kai 'wusel' Siering)
  161. mlelstv@specklec.mpifr-bonn.mpg.de (Michael van Elst)
  162.  
  163. Thanks to bill%solaria@hac2arpa.hac.com (Bill Neisius) for supplying
  164. the .WAV driver, and to Rick Richardson for writing it.
  165.  
  166. If you have any comments on Amiga SOX or on the Sound Tools library,
  167. I may be reached at:
  168.  
  169. David Champion                           Internet E-Mail:
  170. 5326.5 S. Drexel Ave. Apt. 1A
  171. Chicago, IL 60615                        dgc3@midway.uchicago.edu
  172. U.S.A.                                   champion@tira.uchicago.edu
  173. (at least until early summer)
  174.  
  175. See the file "README" for more information on the original
  176. Sound Tools package and its authors.
  177.  
  178. Share and enjoy.
  179.